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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part 3 of a multi-part TS covering the 3"* Generation Partnership Project: Technical 
Specification Group Services and System Aspects, as identified below: 

Part 1: "3G Fault Management Requirements"; 

Part 2: "Alarm Integration Reference Point: Information Service"; 

Part 3: "Alarm Integration Reference Point: CORBA Solution Set"; 

Part 4: "Alarm Integration Reference Point: CMIP Solution Set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document specifies the CORBA Solution Set (SS) for the IRP whose semantics is specified in Alarm IRP: 
Information Service (IS) (3G TS 32.111-2 [6]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. Clause 

5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. Clause 

6 describes the notification interface containing the push method. Annex A contains the IDL specification. 



References 



The following documents contain provisions, which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

[1] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification). 

[3] 3G TS 32.106-8: "Name Convention for Managed Objects". 

[4] 3G TS 32. 106-2: "Notification IRP: Information Service". 

[5] 3G TS 32.106-3: "Notification IRP: CORBA Solution Set". 

[6] 3G TS 32.1 1 1-2: "Alarm Integration Reference Point: Information Service". 

3 Definitions and abbreviations 

3.1 Definitions 

In addition to the terms and definitions defined in TS 32.1 1 1-2 [6], there are no additional definitions applicable to the 
present document. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 

TMN Telecommunications Management Network 

UML Unified Model Language 
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3.3 IRP document version number string 

The IRP document version number (sometimes called "IRP version" or "version number") string is used to identify this 
specification. The string is derived using the following rule. 

Take the 3GPP document number on the front page of this specification, such as "3GPP TS 32.106-3 V3.2.0 (2000- 
12)". Discard the leading "3GPP TS ". Discard all characters after and including the last period. Eliminate leading and 
trailing spaces. Reduce multiple consecutive spaces with one space. Express the resultant in a string. Capitalised the 
string. For example, if the 3GPP document version number is "3GPP TS 32.106-3 V3.2.0 (2000-12)", then the IRP 
document version number shall be "32.106 V3.2". 

This string is returned in getAlarmlRPVersion method and is carried in the first field of the notification header of 
all notifications related to alarm IRP. 



4 Architectural Features 

The overall architectural feature of Alarm IRP is specified in 3G TS 32.1 1 1-2 [6]. This clause specifies features that are 
specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotif ications notifications as specified in 3G TS 32.111-2 [6]. 

4.2 Push and Pull Style 

OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of PuU style is Optional (O). 

4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 

notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 

are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, 

IRP Agent shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, 

IRP Agent shall invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started 

after each push invocation. 

4.4 Filter 

IRP Agent shall optionally support alarm filtering based on IRPManager's supplied alarm filter constraints (e.g., as 
parameter in subscribe() of 3G TS 32.106-2 [4]. Alarm filtering can be applied in the following cases: 

• It is applicable to alarms emitted by IRP Agent via AlarmlRPNotif ications. IRPManager supplies alarm 
filter constraint via the subscribe method. This filter is effective during the period of subscription. 
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• It is applicable to alarms returned by IRP Agent via the out parameter of get_alarm_list method. 
IRPManager supplies alarm filter constraint via the get_alarm_list method. This filter is effective only for 
this method invocation. 

• It is applicable to the calculation of alarm counts returned by IRP Agent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count method. 
This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference OMG Notification Service [I]. The name of the 
grammar is called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in OMG Notification 
Service [1]. This SS shall use this grammar only. 



5 Mapping 

5.1 Operation and Notification mapping 

Alarm IRP: IS 3G TS 32. 111-2 [6] defines semantics of operation and notification visible across the Alarm IRP. Table 
1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table 1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 3G TS 32.111-2 [13] 


SS Method 


Qualifier 


acknowledgeAlarms 


acknowledge_alarms 


M 


unacknowledgeAlarms 


unacknowledge_alarms 


O 


getAlarmList 


get_alarm_list 


M 


get AlarmlRP Vers ion 


get_alarm_IRP_version 


M 


getAlarmCount 


get_alarm_count 


O 


setComment 


set_comment 


O 


notifyNewAlarm 


push_structured_event 

Note that OMG Notification Service OMG Notification 

Service [1] defines this method. 

See clause 6. 1 


M 


notif yClearedAlarm 


push_structured_eventSee clause 6.1 


M 


notifyChangedAlarm 


push_structured_eventSee clause 6.1 


M 


notifyAckStateChanged 


push_structured_eventSee clause 6.1 


M 


notif yAlarmLi St Rebuilt 


push_structured_event 
See clause 6 . 1 


M 


notifyComments 


push_structured_eventSee clause 6.1 


O 



5.2 Operation parameter mapping 

Reference 3G TS 32. Ill -2 [6] defines semantics of parameters carried in operations across the Alarm IRP. The 
following set of tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this 
SS. 

Table 2: Mapping from IS acknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformation 
Ref erenceList 


AlarmlRPConstDefs : : Alarmlnf ormationldSeq 
alarm_inf ormation_id_list 


M 


ackUserld 


string ack_user_id 


M 


ackSystemId 


string ack_system_id 


O 


bad Alarmlnformation 
Ref erenceList 


AlarmlRPConstDefs : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 


M 


status 


CommonlRPConstDef s : : Signal 
Exceptions: 

AcknowledgeAlarms, ParameterNot Supported, 
I nva 1 i dP a r amet e r 


M 
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Table 3: Mapping from IS unacknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarm 
InformationReferenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
alarm_information_id_list 


M 


ackUserld 


string ack_user_id 


M 


ackSystemId 


string ack_system_id 


O 


badAlarm Information 
ReferenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_information_id_list 


M 


status 


CommonlRPConstDefs : : Signal 
Exceptions: 

UnacknowledgeAlarms, Ope rat ionNot Supported, 
ParameterNot Supported, InvalidParameter 


M 



Table 4: Mapping from IS getAlarmList parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


alarmAckState, filter 


string filter 


O 


alarmlnf ormation List 


Return value of type 

AlarmlRPConstDefs : : Alarmlnf ormationSeq 


M 


status 


Exceptions : 

GetAlarmList, ParameterNot Supported, 
InvalidParameter 


M 



Table 5: Mapping from IS getAlarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 


O 


criticalCount, majorCount, 
minorCount, warningCount , 
indeterminateCount, clearedC 
cunt 


long critical_count, long major_count, long 
minor_count, long warning_count , long 
indeterminate_count, long cleared_count 


M 


status 


Exceptions: 

GetAlarmCount, Ope rat ionNot Supported, 
ParameterNot Supported, InvalidParameter 


M 



Table 6: Mapping from IS getAlarmiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberList 


Return value of type 

CommonlRPConstDefs : : VersionNumberSet 


M 


status 


Exceptions: 

GetAlarmiRPVersion 


M 



Table 7: Mapping from IS setcomment parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


Alarmlnf ormation 
ReferenceList 


AlarmlRPConstDefs : : Alarmlnf ormationldSeq 
alarm_inf ormation_id_list 


M 


commentUserld 


string comment_user_id 


M 


comment Systemid 


string comment_system_id 


M 


commentText 


string comment_text 


M 


badAlarmInf ormation IdLi St 


AlarmlRPConstDefs : : BadAlarmInf ormationldSe 
bad_alarm_in format ion_id_li St 
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status 


Exceptions: 

Comment Alarms, Ope rat ionNot Supported. 





5.3 Notification parameter mapping 



Reference 3G TS 32. Ill -2 [6] defines semantics of parameters carried in notifications. The following tables indicate 
the mapping of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [1]) 
equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Heacier 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f lit erable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
Alarm IRP: IS [6] defined notification parameters. 

Table 8: Mapping for notlfyNewAiarm 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 




It carries the IRP document version number string. See sub-clause 3.3. 

It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notification 
Type 


type_name 


M 


This is the NOTIFY_FM_NEW_ALARM of interface 

Notif IcationType of module Notif IcationlRPConstDef s. 


alarmXype 


event_name 


M 


It identifies one of the following: 

• communications alarm, 

• processing error alarm, 

• environmental alarm, 

• quality of service alarm and 

• equipment alarm. 

It is a string. See block of const string definitions encapsulated by 

interface AlarmTypes in the IDL. The strings start with "ET_". 


There is no 
corresponding SS 

attribute. 


variable 
Header 






managedOb jec 
tClass, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


N V stands for name-value pair. Order arrangement of NV pairs is not 
significant. The name of NV-pair is always encoded in string. 

Name of NV pair is the MANAGED_0BJECT_1NSTANCE of 
interface AttributeNameValue of module 
Notif IcationlRPConstDef s . 

Value of NV pair is a string. See corresponding table in Notification IRP: 
CORBA SS (3G TS 32.106-3 [5]). 
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notification 
Id 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the NOTIFICATION_ID of interface 
AttributeNameValue ofmodule 
Notif icationlRPConstDef s . 

Value of NV pair is a long. See corresponding table in Notification IRP: 
CORBA SS (3G TS 32.106-3 [5]). 


eventTime 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module 
Notif icationlRPConstDef s . 

Value of NV pair is a IRP Time. See corresponding table in 
Notification IRP: CORBA SS (3G TS 32.106-3 [5]). 


systemDN 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in Notification IRP: 
CORBA SS [5]. 


probableCaus 
e 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface 
AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a short defined by interface ProbableCause. 


perceivedSev 
erity 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface 
AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a short defined by interface 
PerceivedSeverity. 


specif icProb 
lem 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the SPECIFIC_PROBLEM of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is a string. 


correlatedNo 
tif ications 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the CORRELATED_NOTIFICATIONS of 

interface AttributeNameValue. 

Value of NV pair is a CorrelatedNotif icationSetType . 


backedUpStat 
us 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the BACKED_UP_STATUS of interface 
AttributeNameValue of module AlarmlRPConstDef s 

Value of NV pair is a boolean BackedUpStatusType. 


backUpOb ject 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the B ACKED_UP_OBJECT of interface 

AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a string carrying of DN of the back-up object. See 
3G TS 32.106-8 [3] for the DN string representation. 


trendlndicat 
ion 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the TREND_INDICATION of interface 

AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is an enum TrendlndicationType. 


thresholdinf 
o 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the THRESHOLDJNFO of interface 

ParameterNameValue of module AlarmlRPConstDef s. 

Value of NV pair is an enum ThresholdlndicationType. 


stateChange 
Definition 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the STATE_CHANGE_DEFINITION of interface 

AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is an AttributeChangeSetType . 


monitoredAtt 
ributes 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the MONITORED_ATTRIBUTES of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is an AttributeSetType. 
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proposedRepa 
irActions 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the PROPOSED_REPAIR_ACTIONS of inteface 

AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a string. 


additionalTe 
xt 


One NV pair of 

f ilterable_ 
body_fields 





Name of NV pair is the ADDITIONAL_TEXT of interface 
AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a string. 


alarmld 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the ALARM_ID of interface 
AttributeNameValue of module AlarmlRPConstDef s. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the default 

semantics is that alarmld is a concatenation 

ofmanagedOb jectlnstance, eventType, probableCause 

and specif icProblem, if present, of this Structured Event. Since 

probableCuase is encoded as a short, it shall be converted into string 

before concatenation. The resultant string shall not contain spaces. 


There is no 
corresponding IS 
attribute. 


remaining_ 
body 







Table 9: Mapping for notifyAckStateChanged 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


^^^^^^^^^^^^^^1 Comment ^^^^^^^^^^^^^^^H 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of not i f yNewAlarm. 


notification 


type_name 


M 


This is the NOTIFY_FM_ACK_STATE_CHANGED of inte 


rface 


Type 






Notif icationType of module Notif icationlRPCc 


DnstDef s. 


alarmType 


event_name 


M 


See that of not i f yNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable 
Header 






managedOb jec 
t Class, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not if yNewAlarm. 


notification 
Id 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


eventlime 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


probableCaus 
e 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


perceived 
Severity 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 
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alarmld 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


ackTime 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the ACK_TIME of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pairis a IRPTime of module 
ManagedGenericIRPConstDef s . 


ackUserld 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pair is the ACK_USER_ID of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is a string. 


ackSystemId 


One NV pair of 

filterable_ 
body_fields 





Name of NV pair is the ACK_SYSTEM_ID of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is a string. 


ackState 


One NV pair of 

filterable_ 
body_fields 


M 


Name of NV pairis the ACK_STATE of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is a short defined by interface AckState of 
module AlarmlRPConstDef s. 


There is no 
corresponding IS 

attribute. 


remaining_ 
body 







Table 10: Mapping for notifyClearedAlarm 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notification 


type_name 


M 


This is the NOTIFY_FM_CLEARED_ALARM of interface 




Type 






Notif icationType of module Notif icationlRPCon 


stDefs. 


alarmType 


event_name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable 
Header 






managedOb jec 
t Class, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


notification 
Id 


One NV pair of 

f ilterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


eventlime 


One NV pair of 

f ilterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


probableCaus 
e 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


perceived 
Severity 


One NV pair of 

filterable_ 


M 


See that of notifyNewAlarm. 
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body_fields 






alarmld 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


remaining_ 
body 







Table 11: Mapping for notifyAlarmListRebuilt 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 




There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notification 
Type 


type_name 


M 


This is the NOTIFY_FM_ALARM_LIST_REBUILT of interface 
NotificationType of module NotificationlRPConstDefs. 


There is no 
corresponding IS 
attribute. 


event_name 


M 


Carry an empty string. 


There is no 
corresponding IS 
attribute. 


variable 
Header 






managedOb jec 
t Class, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


notification 
Id 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


eventlime 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 

filterable_ 
body_fields 


O 


See that of not i f yNewAlarm. 


reason 


One NV pair of 

filterable_ 
body_fields 


M 


It is a string. 


There is no 
corresponding IS 
attribute. 


remaining_ 
body 







Table 12: Mapping for notifyChangedAlarm 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


, 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of not i f yNewAlarm. 


notification 
Type 


type_name 


M 


This is the NOTIFY_FM_CHANGED_ALARMof interface 
NotificationType of module NotificationlRPConstDefs. 


alarmlype 


event_name 


M 


See that of not i f yNewAlarm. 
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There is no 
corresponding IS 
attribute. 


variable 
Header 






managedOb jec 
tClass, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notif yNewAlarm. 


notification 
Id 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


eventlime 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


probableCaus 
e 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


perceived 
Severity 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


remaining_ 
body 







Table 13: Mapping for notifyComments 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment ^^^^^^^^^^^^^^M 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notification 


type_name 


M 


This is the NOTIFY_FM_CLEARED_ALARMof interface 




Type 






Notif icationlype of module Notif icationlRPCon 


stDefs. 


alarmlype 


event_name 


M 


See that of not i f yNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable 
Header 






managedOb jec 
tClass, 
managedOb jec 
tinstance 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


notification 
Id 


One NV pair of 

filterable_ 
body_fields 


M 


See that of not i f yNewAlarm. 


eventlime 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


probableCaus 
e 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 
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perceived 
Severity 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 

filterable_ 
body_fields 


M 


See that of notifyNewAlarm. 


comments 




M 


Name of NV pair is the COMMENTS of interface 
AttributeNameValue of module AlarmlRPConstDef s . 

Value of NV pair is a CommentSet. 


There is no 
corresponding IS 
attribute. 


remaining_ 
body 







6 AlarmlRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNotifications. All the 
notifications in this interface are implemented using this push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events { 

in CosNotif ication : : EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 

} ; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specification 

#include "CosNotif ication . idl" 
#include "generic . idl" 

#ifndef AlarmIRP_idl 
#define AlarmIRP_idl 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPConstDef s 

This module contains commonly used definitions for Alarm IRP 

V 

module AlarmlRPConstDef s 

{ 

/* 

Define the this Alarm IRP version. 

This string is used for the return value of 

get_alarm_IRP_versions ( ) . 
It is used as return value of get_notif ication_categories { ) 

if the Notification IRP supports the emission of notifications 
defined by this Alarm IRP version. 
It is also used in the domain_name attribute of a structured event 
carrying alarm information defined by this Alarm IRP version. 

See definition "IRP document version number string". 

V 

const string ALARM_IRP_VERSION = "<to be updated using the rule>"; 

/* 

This block identifies the alarm types specified for this IRP version. 

These types carry the same semantics as the TMN ITU-T defined event 

types of the same name. 

Their encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

alarm types for their use. They shall define their encodings 

as well. Values defined here are unique among themselves. 

*/ 

interface AlarmType 

{ 

const string COMMUNICATIONS_ALARM = "xl"; 

const string PROCESSING_ERROR_ALARM = "x2"; 

const string ENVIRONMENTAL_ALARM = "x3"; 

const string QUALITY_OF_SERVICE_ALARM = "x4"; 

const string EQUIPMENT_ALARM = "x5"; 

}; 

/* 

This block identifies the notification types defined by this 

Alarm IRP version. 

*/ 

interface Notif icationType 

{ 

const string NOTIFY_FM_NEW_ALARM = "xl"; 

const string NOTIFY_FM_CHANGED_ALARM = "x2"; 

const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 

const string NOTIFY_FM_COMMENT_ADDED = "x4"; 
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const string NOTIFY_FM_CLEARED_ALARM = "x5"; 

const string NOTIFY_FM_ALARM_LIST_REBUILT = "x6"; 

}; 

/* 

This block identifies the levels of severity. 

*/ 

interface PerceivedSeverity 

{ 

const short INDETERMINATE = 1; 

const short CRITICAL = 2 ; 

const short MAJOR = 3; 

const short MINOR = 4 ; 

const short WARNING = 5; 

const short CLEARED = 6; 

}; 

/* 

This block identifies the probable cause of a reported alarm. 

*/ 

interface ProbableCause 

{ 

const short ALARM_INDICATION_SIGNAL = 1 ; 

const short CALL_SETUP_FAILURE = 2 ; 

const short DEGRADED_SIGNAL_M310 = 3; 

const short FAR_END_RECEIVER_FAILURE = 4 ; 

const short FRAMING_ERROR_M3100 = 5; 

const short LOSS_OF_FRAME = 6; 

const short LOSS_OF_POINTER = 7 ; 

const short LOSS_OF_SIGNAL = 8 ; 

const short PAYLOAD_TYPE_MISMATCH = 9; 

const short TRANSMISSION_ERROR = 10; 

const short REMOTE_ALARM_INTERFACE = 11; 

const short EXCESSIVE_BIT_ERROR_RATE = 12; 

const short PATH_TRACE_MISMATCH = 13; 

const short UNAVAILABLE = 14; 

const short SIGNAL_LABEL_MISMATCH = 15; 

const short LOSS_OF_MULTI_FRAME = 16; 

const short BACK_PLANE_FAILURE = 51; 

const short DATA_SET_PROBLEM = 52; 

const short EQUIPMENT_IDENTIFIER_DUPLICATION = 53; 

const short EXTERNAL_DEVICE_PROBLEM = 54; 

const short LINE_CARD_PROBLEM = 55; 

const short MULTIPLEXER_PROBLEM_M3100 = 56; 

const short NE_IDENTIFIER_DUPLICATION = 57; 

const short POWER_PROBLEM_M310 = 58; 

const short PROCESSOR_PROBLEM_M3100 = 59; 

const short PROTECTION_PATH_FAILURE = 60; 

const short RECEIVER_FAILURE_M310 = 61; 

const short REPLACEABLE_UNIT_MISSING = 62; 

const short REPLACEABLE_UNIT_TYPE_MISMATCH = 63; 

const short SYNCHRONISATION_SOURCE_MISMATCH = 64; 

const short TERMINAL_PROBLEM = 65; 

const short TIMING_PROBLEM_M310 = 66; 

const short TRANSMITTER_FAILURE_M310 = 67; 

const short TRUNK_CARD_PROBLEM = 68; 

const short REPLACEABLE_UNIT_PROBLEM = 69; 

const short AIR_COMPRESSOR_FAILURE = 101; 

const short AIR_CONDITIONING_FAILURE = 102; 

const short AIR_DRYER_FAILURE = 103; 

const short BATTERY_DISCHARGING = 104; 

const short BATTERY_FAILURE = 105; 

const short COMMERICAL_POWER_FAILURE = 106; 
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const short COOL ING_FAN_FAI LURE = 107; 

const short ENGINE_FAILURE = 108; 

const short FIRE_DETECTOR_FAILURE = 10 9; 

const short FUSE_FAILURE = 110; 

const short GENERATOR_FAILURE = 111; 

const short LOW_BATTERY_THRESHOLD = 112; 

const short PUMP_FAILURE_M3100 = 113; 

const short RECTIFIER_FAILURE = 114; 

const short RECTIFIER_HIGH_VOLTAGE = 115; 

const short RECTIFIER_LOW_F_VOLTAGE = 116; 

const short VENTILATION_SYSTEM_FAILURE = 117; 

const short ENCLOSURE_DOOR_OPEN_M310 = 118; 

const short EXPLOSIVE_GAS = 119; 

const short FIRE = 120; 

const short FLOOD = 121; 

const short HIGH_HUMIDITY = 122; 

const short HIGH_TEMPERATURE = 123; 

const short HIGH_WIND = 124; 

const short ICE_BUILD_UP = 125; 

const short INTRUSION_DETECTION = 126; 

const short LOW_FUEL = 12 7; 

const short LOW_HUMIDITY = 128; 

const short LOW_CABLE_PRESSURE = 129; 

const short LOW_TEMPERATURE = 130; 

const short LOW_WATER = 131; 

const short SMOKE = 132; 

const short TOXIC_GAS = 133; 

const short STORAGE_CAPACITY_PROBLEM_M3100 = 151; 

const short MEMORY_MISMATCH = 152; 

const short CORRUPT_DATA_M310 = 153; 

const short OUT_OF_CPU_CYCLES = 154; 

const short SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

const short SOFTWARE_DOWNLOAD_FAILURE = 156; 

const short ADAPTER_ERROR = 301; 

const short APPLICATION_SUBSYSTEM_FAILURE = 302; 

const short BANDWIDTH_REDUCTION = 303; 

const short COMMUNICATION_PROTOCOL_ERROR = 305; 

const short COMMUNICATION_SUBSYSTEM_FAILURE = 306; 

const short CONFIGURATION_OR_CUSTOMIZING_ERROR = 307; 

const short CONGESTION = 308; 

const short CPU_CYCLES_LIMIT_EXCEEDED = 310; 

const short DATA_SET_OR_MODEM_ERROR = 311; 

const short DTE_DCE_INTERFACE_ERROR = 313; 

const short EQUIPMENT_MALFUNCTION = 315; 

const short EXCESSIVE_VIBRATION = 316; 

const short FILE_ERROR = 317; 

const short HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM = 321; 

const short HUMIDITY_UNACCEPTABLE = 322; 

const short INPUT_OUTPUT_DEVICE_ERROR = 323; 

const short INPUT_DEVICE_ERROR = 32 4; 

const short LAN_ERROR = 325; 

const short LEAK_DETECTION = 32 6; 

const short LOCAL_NODE_TRANSMISSION_ERROR = 327; 

const short MATERIAL_SUPPLY_EXHAUSTED = 330; 

const short OUT_OF_MEMORY = 332; 

const short OUTPUT_DEVICE_ERROR = 333; 

const short PERFORMANCE_DEGRADED = 334; 

const short PRESSURE_UNACCEPTABLE = 33 6; 

const short QUEUE_SIZE_EXCEEDED = 339; 

const short RECEIVE_FAILURE = 340; 

const short REMOTE_NODE_TRANSMISSION_ERROR = 342; 

const short RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

const short RESPONSE_TIME_EXCESSIVE = 344; 
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const short RETRANSMISSION_RATE_EXCESSIVE = 345; 

const short SOFTWARE_ERROR = 34 6; 

const short SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 34 7; 

const short SOFTWARE_PROGRAM_ERROR = 34 8; 

const short TEMPERATURE_UNACCEPTABLE = 350; 

const short THRESHOLD_CROSSED = 351; 

const short TOXIC_LEAK_DETECTED = 353; 

const short TRANSMIT_FAILURE = 354; 

const short UNDERLYING_RESOURCE_UNAVAILABLE = 35 6; 

const short VERSION_MISMATCH = 357; 

const short A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

const short A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

const short ANTENNA_PROBLEM = 503; 

const short BATTERY_BREAKDOWN = 504; 

const short BATTERY_CHARGING_FAULT = 505; 

const short CLOCK_SYNCHRONISATION_PROBLEM = 506; 

const short COMBINER_PROBLEM = 507; 

const short DISK_PROBLEM = 508; 

const short EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

const short EXCESSIVE_TRANSMITTER_OUTPUT_POWER = 511; 

const short EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

const short FREQUENCY_HOPPING_DEGRADED = 513; 

const short FREQUENCY_HOPPING_FAILURE = 514; 

const short FREQUENCY_REDEFINITION_FAILED = 515; 

const short LINE_INTERFACE_FAILURE = 516; 

const short LINK_FAILURE = 517; 

const short LOSS_OF_SYNCHRONISATION = 518; 

const short LOST_REDUNDANCY = 519; 

const short MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 52 0; 

const short MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

const short POWER_SUPPLY_FAILURE = 522; 

const short RECEIVER_ANTENNA_FAULT = 523; 

const short RECEIVER_MULTICOUPLER_FAILURE = 525; 

const short REDUCED_TRANSMITTER_OUTPUT_POWER = 52 6; 

const short SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

const short TIMESLOT_HARDWARE_FAILURE = 52 8; 

const short TRANSCEIVER_PROBLEM = 52 9; 

const short TRANSCODER_PROBLEM = 530; 

const short TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

const short TRANSMITTER_ANTENNA_FAILURE = 532; 

const short TRANSMITTER_ANTENNA_NOT_AD JUSTED = 533; 

const short TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 

const short TRANSMITTER_OFF_FREQUENCY = 53 6; 

const short DATABASE_INCONSISTENCY = 537; 

const short FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 

const short INPUT_PARAMETER_OUT_OF_RANGE = 53 9; 

const short INVALID_PARAMETER = 54 0; 

const short INVALID_POINTER = 541; 

const short MESSAGE_NOT_EXPECTED = 542; 

const short MESSAGE_NOT_INITIALISED = 543; 

const short MESSAGE_OUT_OF_SEQUENCE = 544; 

const short SYSTEM_CALL_UNSUCCESSFUL = 545; 

const short TIMEOUT_EXPIRED = 546; 

const short VARIABLE_OUT_OF_RANGE = 54 7; 

const short WATCH_DOG_TIMER_EXPIRED = 548; 

const short COOLING_SYSTEM_FAILURE = 54 9; 

const short EXTERNAL_EQUIPMENT_FAILURE = 550; 

const short EXTERNAL_POWER_SUPPLY_FAILURE = 551; 

const short EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 

const short REDUCED_ALARM_REPORTING = 561; 

const short REDUCED_EVENT_REPORTING = 5 62; 

const short RECUCED_LOGGING_CAP ABILITY = 5 63; 

const short SYSTEM_RESOURCES_OVERLOAD = 5 64; 
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const short BROADCAST_CHANNEL_FAILURE = 5 65; 

const short CALL_ESTABLISHMENT_ERROR = 5 6 6; 

const short INVALID_MESSAGE_RECEIVED = 567; 

const short INVALID_MSU_RECEIVED = 5 68; 

const short LAPD_LINK_PROTOCOL_FAILURE = 5 69; 

const short LOCAL_ALARM_INDICATION = 570; 

const short REMOTE_ALARM_INDICATION = 571; 

const short ROUTING_FAILURE = 572; 

const short SS7_PR0T0C0L_FAILURE = 573; 

const short TRANSMISSION_FAILURE = 574; 

}; 

/* 

This block identifies the acknowledgement state of a reported alarm. 

*/ 

interface AckState 

{ 

const short ACKNOWLEDGED = 1; 

const short UNACKNOWLEDGED = 2; 

}; 

/* 

This block identifies attributes which are included as part of the Alarm IRP 

These attribute values should not clash with those defined for the attributes 

of notification header (see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string ALARM_ID = "f"; 



const string PERCEIVED_SEVERITY = "h"; 
const string SPECIFIC_PROBLEM = "i"; 
const string ADDITIONAL_TEXT = "j"; 
const string ACK_TIME = "k"; 
const string ACK_USER_ID = "1"; 
const string ACK_SYSTEM_ID = "m"; 
const string ACK_STATE = "n"; 
const string COMMENTS = "o"; 
const string BACKED_UP_STATUS = "p"; 
const string BACK_UP_OBJECT = "q"; 
const string THRESHOLD_INFO = "r"; 
const string TREND_INDICATION = "s"; 
const string STATE_CHANGE_DEFINITION = "t 
const string MONITORED_ATTRIBUTES = "u"; 
const string PROPOSED_REPAIR_ACTIONS = "v 
const string CORRELATED_NOTIFICATIONS 
const string REASON = "x"; 



" T.T " ' 



}, 



Defines the content of a Comment 

*/ 

struct Comment 

{ 

ManagedGenericIRPConstDef s : : IRPTime comment_time; 

string comment_text ; 

string user_id; 

string system_id; 

}; 

/* 

Defines a set of comments which are placed in the COMMENTS attribute 

of a structured event. 
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*/ 

typedef sequence <Comment> CommentSet; 

/* 

It indicates if an object has a back up. 

True implies backed up. False implies not backed up. 

*/ 

typedef boolean BackedUpStatusType; 

/* 

It indicates if the threshold crossed was in the up or down direction. 

*/ 

enum ThresholdlndicationType {Up, Down}; 

/* 

It indicates if some observed condition is getting better, worse, 

or not changing. 

V 

enum TrendlndicationType {LessSevere, NoChange, MoreSevere } ; 

/* 

It is used to report a changed attribute value. 

*/ 

struct AttributeValueChangeType 

{ 

string attribute_name; 

any old_value; // type depends on attribute 

any new_value; // type depends on attribute 

}; 

typedef sequence <AttributeValueChangeType> AttributeChangeSetType; 

/* 

It is used to report an attribute and its value. 

V 

struct AttributeValueType 

{ 

string attribute_name; 

any value; // type depends on the attribute 

}; 

typedef sequence <AttributeValueType> AttributeSetType; 
typedef sequence <long> Notif IdSetType; 

/* 

This holds identifiers of notifications that are correlated. 

*/ 

struct CorelatedNotif ication 

{ 

string source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
Notif IdSetType notif_id_set ; // Set of related notification ids 

}; 

/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

V 
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typedef sequence <CorelatedNotif ication> CorrelatedNotif icationSetType; 

/* 

Define the structure returned when an operation fails for a set of alarm ids. 

A reason is provided in order to indicate why the operation failed. 

*/ 

struct BadAlarmInf ormationldSeq 

{ 

string alarm_inf ormation_ref erence; 

string reason; 

}; 

typedef sequence <string> Alarmlnf ormationldSeq; 
typedef CosNotif ication : :EventBatch Alarmlnf ormationSeq; 

}; 

/* ## Module: AlarmlRPSystem 

This module contains the specification of all operations of Alarm IRP Agent. 

*/ 

module AlarmlRPSystem 

{ 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetAlarmlRPVersions { string reason; }; 

exception GetAlarmlRPOperationsProf ile { string reason; }; 

exception GetAlarmlRPNotif icationProf ile { string reason; }; 

exception AcknowledgeAlarms { string reason; }; 

exception UnacknowledgeAlarms { string reason; }; 

exception CommentAlarms { string reason; }; 

exception GetAlarmList { string reason; }; 

exception GetAlarmCount { string reason; }; 

exception NextAlarmlnformations { string reason; }; 

/* 

The Alarmlnf ormationlterator is used to iterate through a snapshot of 
Alarm Informations taken from the Alarm List when IRPManager invokes 
get_alarm_list . IRPManager uses it to pace the return of Alarm 
Informations . 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface Alarmlnf ormationlterator 

{ 

/* 

This method returns between 1 and "how_many" Alarm Informations. The 
IRPAgent may return less than "how_many" items even if there are more 
items to return. "how_many" must be non-zero. Return TRUE if there may 
be more Alarm Information to return. Return FALSE if there are no more 
Alarm Information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 

iterator . 

*/ 

boolean next_alarmInformations ( 

in unsigned short how_many, 

out AlarmlRPConstDef s :: Alarmlnf ormationSeq alarm_inf ormations 
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raises (NextAlarmlnformations, ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method destroys the iterator. 

*/ 

void destroy ( ) ; 

}; 



interface AlarmlRP 
{ 

/* 

Return the list of all supported Alarm IRP versions. 

*/ 

ManagedGenericIRPConstDef s : : VersionNumberSet get_alarm_IRP_versions ( 

) 

raises (GetAlarmlRPVersions) ; 



/* 

Return the list of all supported operations and their supported 

parameters for a specific Alarm IRP version. 

V 

ManagedGenericIRPConstDef s : :MethodList get_alarm_IRP_operations_prof ile ( 

in ManagedGenericIRPConstDef s : :VersionNumber alarm_irp_version 
) 
raises ( GetAlarmlRPOperat ion sPro file, 

ManagedGenericIRPSystem: : Ope rat ionNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 
parameters for a specific Alarm IRP version. 
*/ 

ManagedGenericIRPConstDef s : :MethodList get_alarm_IRP_notif ication_prof ile 
{ 

in ManagedGenericIRPConstDef s : :VersionNumber alarm_irp_version 
) 
raises (GetAlarmlRPNotif icationProf ile, 

ManagedGenericIRPSystem: : Ope rat ionNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



/* 

Request to acknowledge one or more alarms. 

V 

ManagedGenericIRPConstDef s :: Signal ack;nowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 

in string ack_user_id, 

in string ack_system_id, 

out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises (AcknowledgeAlarms, ManagedGenericIRPSystem: :ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



/* 

Request to remove acknowledgement information of one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal unacknowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 

in string ack_user_id. 
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in string ack._system_id, 

out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 
raises (UnacknowledgeAlarms, 

ManagedGenericIRP System: : Ope rat ionNot Supported, 
ManagedGenericIRP System: : ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Make comment to one or more alarms . 

V 

ManagedGenericIRPConstDef s :: Signal comment_alarms { 

in AlarmlRPConstDef s : :AlarmInf ormationldSeq alarm_inf ormation_id_list , 
in string comment_user_id, 
in string comment_system_id, 
in string comment_text , 

out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises (CommentAlarms, ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 

in Alarmlnf ormationSeq that contains or more Alarm Informations. 

Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in Alarmlnf ormationSeq . 

IRPAgent needs to use iter to retrieve them. 

V 

AlarmlRPConstDef s :: Alarmlnf ormationSeq get_alarm_list { 

in string filter, 

out boolean flag, 

out Alarmlnf ormationlterator iter 
) 

raises (GetAlarmList, ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns the count of Alarm Informations. 

*/ 

void get_alarm_count { 

in string filter, 

out unsigned long critical_count , 

out unsigned long major_count, 

out unsigned long minor_count, 

out unsigned long warning_count , 

out unsigned long indeterminate_count , 

out unsigned long cleared_count 
) 

raises (GetAlarmCount, ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

}; 
}; 

#endif 
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Annex B (informative): 
Change history 



Change history 
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TSG# 


TSG Doc. 


CR 
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Old 
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Mar 2000 


S_07 
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Approved at TSG SA #7 and placed under Change Control 


2.0.0 


3.0.0 


Mar 2000 




- 


- 




cosmetic 


3.0.0 
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Jun 2000 
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3.3.0 


Mar 2001 


S_11 
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3.4.0 


Mar 2001 


S 11 
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